<!DOCTYPE HTML PUBLIC "-//ORA//DTD CD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE>[Chapter 18] 18.38 java.awt.List (JDK 1.0)</TITLE>
<META NAME="author" CONTENT="David Flanagan">
<META NAME="date" CONTENT="Thu Jul 31 16:10:25 1997">
<META NAME="form" CONTENT="html">
<META NAME="metadata" CONTENT="dublincore.0.1">
<META NAME="objecttype" CONTENT="book part">
<META NAME="otheragent" CONTENT="gmat dbtohtml">
<META NAME="publisher" CONTENT="O'Reilly &amp; Associates, Inc.">
<META NAME="source" CONTENT="SGML">
<META NAME="subject" CONTENT="Java">
<META NAME="title" CONTENT="Java in a Nutshell">
<META HTTP-EQUIV="Content-Script-Type" CONTENT="text/javascript">
</HEAD>
<body vlink="#551a8b" alink="#ff0000" text="#000000" bgcolor="#FFFFFF" link="#0000ee">

<DIV CLASS=htmlnav>
<H1><a href='index.htm'><IMG SRC="gifs/smbanner.gif"
     ALT="Java in a Nutshell" border=0></a></H1>
<table width=515 border=0 cellpadding=0 cellspacing=0>
<tr>
<td width=172 align=left valign=top><A HREF="ch18_37.htm"><IMG SRC="gifs/txtpreva.gif" ALT="Previous" border=0></A></td>
<td width=171 align=center valign=top><B><FONT FACE="ARIEL,HELVETICA,HELV,SANSERIF" SIZE="-1">Chapter 18<br>The java.awt Package</FONT></B></TD>
<td width=172 align=right valign=top><A HREF="ch18_39.htm"><IMG SRC="gifs/txtnexta.gif" ALT="Next" border=0></A></td>
</tr>
</table>

&nbsp;
<hr align=left width=515>
</DIV>
<DIV CLASS=sect1>
<h2 CLASS=sect1><A CLASS="TITLE" NAME="JNUT2-CH-18-SECT-38">18.38 java.awt.List (JDK 1.0)</A></h2>

<DIV CLASS=sect2>
<h3 CLASS=sect2><A CLASS="TITLE" NAME="JNUT2-CH-18-SECT-38.1"></A></h3>
</DIV>

<P CLASS=para>
This class is a <tt CLASS=literal>Component</tt> that graphically displays a list of
strings.  The list is scrollable if necessary.  The
constructor takes optional arguments that specify the number
of visible rows in the list and whether selection of more
than one item is allowed.  The various instance methods allow strings
to be added and removed from the <tt CLASS=literal>List</tt>, and allow the
selected item or items to be queried.

<DIV CLASS=screen>
<P>
<PRE>
public class <tt CLASS=literal>List</tt> extends Component implements ItemSelectable {
    // <tt CLASS=literal>Public Constructors</tt>
            public <tt CLASS=literal>List</tt>();
        <b>1.1</b>  public <tt CLASS=literal>List</tt>(int <tt CLASS=literal>rows</tt>);
            public <tt CLASS=literal>List</tt>(int <tt CLASS=literal>rows</tt>, boolean <tt CLASS=literal>multipleMode</tt>);
    // <tt CLASS=literal>Public Instance Methods</tt>
        <b>1.1</b>  public void <tt CLASS=literal>add</tt>(String <tt CLASS=literal>item</tt>);
        <b>1.1</b>  public synchronized void <tt CLASS=literal>add</tt>(String <tt CLASS=literal>item</tt>, int <tt CLASS=literal>index</tt>);
        <b>1.1</b>  public synchronized void <tt CLASS=literal>addActionListener</tt>(ActionListener <tt CLASS=literal>l</tt>);
            public void <tt CLASS=literal>addItem</tt>(String <tt CLASS=literal>item</tt>);
            public synchronized void <tt CLASS=literal>addItem</tt>(String <tt CLASS=literal>item</tt>, int <tt CLASS=literal>index</tt>);
        <b>1.1</b>  public synchronized void <tt CLASS=literal>addItemListener</tt>(ItemListener <tt CLASS=literal>l</tt>);  //<tt CLASS=literal> From ItemSelectable</tt>
            public void <tt CLASS=literal>addNotify</tt>();  //<tt CLASS=literal> Overrides Component</tt>
        #   public boolean <tt CLASS=literal>allowsMultipleSelections</tt>();
        #   public synchronized void <tt CLASS=literal>clear</tt>();
        #   public int <tt CLASS=literal>countItems</tt>();
            public synchronized void <tt CLASS=literal>delItem</tt>(int <tt CLASS=literal>position</tt>);
        #   public synchronized void <tt CLASS=literal>delItems</tt>(int <tt CLASS=literal>start</tt>, int <tt CLASS=literal>end</tt>);
            public synchronized void <tt CLASS=literal>deselect</tt>(int <tt CLASS=literal>index</tt>);
            public String <tt CLASS=literal>getItem</tt>(int <tt CLASS=literal>index</tt>);
        <b>1.1</b>  public int <tt CLASS=literal>getItemCount</tt>();
        <b>1.1</b>  public synchronized String[] <tt CLASS=literal>getItems</tt>();
        <b>1.1</b>  public Dimension <tt CLASS=literal>getMinimumSize</tt>(int <tt CLASS=literal>rows</tt>);
        <b>1.1</b>  public Dimension <tt CLASS=literal>getMinimumSize</tt>();  //<tt CLASS=literal> Overrides Component</tt>
        <b>1.1</b>  public Dimension <tt CLASS=literal>getPreferredSize</tt>(int <tt CLASS=literal>rows</tt>);
        <b>1.1</b>  public Dimension <tt CLASS=literal>getPreferredSize</tt>();  //<tt CLASS=literal> Overrides Component</tt>
            public int <tt CLASS=literal>getRows</tt>();
            public synchronized int <tt CLASS=literal>getSelectedIndex</tt>();
            public synchronized int[] <tt CLASS=literal>getSelectedIndexes</tt>();
            public synchronized String <tt CLASS=literal>getSelectedItem</tt>();
            public synchronized String[] <tt CLASS=literal>getSelectedItems</tt>();
        <b>1.1</b>  public Object[] <tt CLASS=literal>getSelectedObjects</tt>();  //<tt CLASS=literal> From ItemSelectable</tt>
            public int <tt CLASS=literal>getVisibleIndex</tt>();
        <b>1.1</b>  public boolean <tt CLASS=literal>isIndexSelected</tt>(int <tt CLASS=literal>index</tt>);
        <b>1.1</b>  public boolean <tt CLASS=literal>isMultipleMode</tt>();
        #   public boolean <tt CLASS=literal>isSelected</tt>(int <tt CLASS=literal>index</tt>);
            public synchronized void <tt CLASS=literal>makeVisible</tt>(int <tt CLASS=literal>index</tt>);
        #   public Dimension <tt CLASS=literal>minimumSize</tt>(int <tt CLASS=literal>rows</tt>);
        #   public Dimension <tt CLASS=literal>minimumSize</tt>();  //<tt CLASS=literal> Overrides Component</tt>
        #   public Dimension <tt CLASS=literal>preferredSize</tt>(int <tt CLASS=literal>rows</tt>);
        #   public Dimension <tt CLASS=literal>preferredSize</tt>();  //<tt CLASS=literal> Overrides Component</tt>
        <b>1.1</b>  public synchronized void <tt CLASS=literal>remove</tt>(String <tt CLASS=literal>item</tt>);
        <b>1.1</b>  public synchronized void <tt CLASS=literal>remove</tt>(int <tt CLASS=literal>position</tt>);
        <b>1.1</b>  public synchronized void <tt CLASS=literal>removeActionListener</tt>(ActionListener <tt CLASS=literal>l</tt>);
        <b>1.1</b>  public synchronized void <tt CLASS=literal>removeAll</tt>();
        <b>1.1</b>  public synchronized void <tt CLASS=literal>removeItemListener</tt>(ItemListener <tt CLASS=literal>l</tt>);  //<tt CLASS=literal> From ItemSelectable</tt>
            public void <tt CLASS=literal>removeNotify</tt>();  //<tt CLASS=literal> Overrides Component</tt>
            public synchronized void <tt CLASS=literal>replaceItem</tt>(String <tt CLASS=literal>newValue</tt>, int <tt CLASS=literal>index</tt>);
            public synchronized void <tt CLASS=literal>select</tt>(int <tt CLASS=literal>index</tt>);
        <b>1.1</b>  public synchronized void <tt CLASS=literal>setMultipleMode</tt>(boolean <tt CLASS=literal>b</tt>);
        #   public synchronized void <tt CLASS=literal>setMultipleSelections</tt>(boolean <tt CLASS=literal>b</tt>);
    // <tt CLASS=literal>Protected Instance Methods</tt>
            protected String <tt CLASS=literal>paramString</tt>();  //<tt CLASS=literal> Overrides Component</tt>
        <b>1.1</b>  protected void <tt CLASS=literal>processActionEvent</tt>(ActionEvent <tt CLASS=literal>e</tt>);
        <b>1.1</b>  protected void <tt CLASS=literal>processEvent</tt>(AWTEvent <tt CLASS=literal>e</tt>);  //<tt CLASS=literal> Overrides Component</tt>
        <b>1.1</b>  protected void <tt CLASS=literal>processItemEvent</tt>(ItemEvent <tt CLASS=literal>e</tt>);
}
</PRE>
</DIV>

</DIV>

<DIV CLASS=sect2>
<h3 CLASS=sect2><A CLASS="TITLE" NAME="JNUT2-CH-18-SECT-38.2">Hierarchy:</A></h3>

<P CLASS=para>
<tt CLASS=literal>Object->Component(ImageObserver, MenuContainer, Serializable)->List(ItemSelectable)</tt>

</DIV>

<DIV CLASS=sect2>
<h3 CLASS=sect2><A CLASS="TITLE" NAME="JNUT2-CH-18-SECT-38.3">Passed To:</A></h3>

<P CLASS=para>
<tt CLASS=literal>Toolkit.createList()</tt>

</DIV>

</DIV>


<DIV CLASS=htmlnav>

<P>
<HR align=left width=515>
<table width=515 border=0 cellpadding=0 cellspacing=0>
<tr>
<td width=172 align=left valign=top><A HREF="ch18_37.htm"><IMG SRC="gifs/txtpreva.gif" ALT="Previous" border=0></A></td>
<td width=171 align=center valign=top><a href="index.htm"><img src='gifs/txthome.gif' border=0 alt='Home'></a></td>
<td width=172 align=right valign=top><A HREF="ch18_39.htm"><IMG SRC="gifs/txtnexta.gif" ALT="Next" border=0></A></td>
</tr>
<tr>
<td width=172 align=left valign=top>java.awt.LayoutManager2 (JDK 1.1)</td>
<td width=171 align=center valign=top><a href="index/idx_0.htm"><img src='gifs/index.gif' alt='Book Index' border=0></a></td>
<td width=172 align=right valign=top>java.awt.MediaTracker (JDK 1.0)</td>
</tr>
</table>
<hr align=left width=515>

<IMG SRC="gifs/smnavbar.gif" USEMAP="#map" BORDER=0> 
<MAP NAME="map"> 
<AREA SHAPE=RECT COORDS="0,0,108,15" HREF="../javanut/index.htm"
alt="Java in a Nutshell"> 
<AREA SHAPE=RECT COORDS="109,0,200,15" HREF="../langref/index.htm" 
alt="Java Language Reference"> 
<AREA SHAPE=RECT COORDS="203,0,290,15" HREF="../awt/index.htm" 
alt="Java AWT"> 
<AREA SHAPE=RECT COORDS="291,0,419,15" HREF="../fclass/index.htm" 
alt="Java Fundamental Classes"> 
<AREA SHAPE=RECT COORDS="421,0,514,15" HREF="../exp/index.htm" 
alt="Exploring Java"> 
</MAP>
</DIV>

</BODY>
</HTML>
